<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Linearizes data within buffer
  and returns it's contents as a string</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="eventbuffer.prependbuffer.html">« EventBuffer::prependBuffer</a></li>
      <li style="float: right;"><a href="eventbuffer.read.html">EventBuffer::read »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="class.eventbuffer.html">EventBuffer</a></li>
    <li>Linearizes data within buffer
  and returns it's contents as a string</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="eventbuffer.pullup" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">EventBuffer::pullup</h1>
  <p class="verinfo">(PECL event &gt;= 1.2.6-beta)</p><p class="refpurpose"><span class="refname">EventBuffer::pullup</span> &mdash; <span class="dc-title">Linearizes data within buffer
  and returns it&#039;s contents as a string</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-eventbuffer.pullup-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span>
   <span class="methodname"><strong>EventBuffer::pullup</strong></span>(<span class="methodparam">
    <span class="type">int</span>
     <code class="parameter">$size</code>
   </span>): <span class="type">string</span></div>

  <p class="para rdfs-comment">
   &quot;Linearizes&quot; the first
   <code class="parameter">size</code>
   bytes of the buffer, copying or moving them as needed to ensure that they
   are all contiguous and occupying the same chunk of memory. If size is
   negative, the function linearizes the entire buffer.
  </p>
  <div class="warning"><strong class="warning">警告</strong>
   <p class="para">
    Calling
    <span class="methodname"><strong>EventBuffer::pullup()</strong></span>
    with a large size can be quite slow, since it potentially needs to copy
    the entire buffer&#039;s contents.
   </p>
  </div>
 </div>

 <div class="refsect1 parameters" id="refsect1-eventbuffer.pullup-parameters">
  <h3 class="title">参数</h3>
  <dl>
   
    <dt>

     <code class="parameter">size</code>
    </dt>

    <dd>

     <p class="para">
      The number of bytes required to be contiguous within the buffer.
     </p>
    </dd>

   
  </dl>

 </div>

 <div class="refsect1 returnvalues" id="refsect1-eventbuffer.pullup-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   If
   <code class="parameter">size</code>
   is greater than the number of bytes in the buffer, the function returns
   <strong><code>null</code></strong>. Otherwise,
   <span class="methodname"><strong>EventBuffer::pullup()</strong></span>
   returns string.
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-eventbuffer.pullup-seealso">
  <h3 class="title">参见</h3>
  <ul class="simplelist">
   <li class="member">
    <span class="methodname"><a href="eventbuffer.copyout.html" class="methodname" rel="rdfs-seeAlso">EventBuffer::copyout()</a> - Copies out specified number of bytes from the front of the buffer</span>
   </li>
   <li class="member">
    <span class="methodname"><a href="eventbuffer.drain.html" class="methodname" rel="rdfs-seeAlso">EventBuffer::drain()</a> - Removes specified number of bytes from the front of the buffer
  without copying it anywhere</span>
   </li>
   <li class="member">
    <span class="methodname"><a href="eventbuffer.read.html" class="methodname" rel="rdfs-seeAlso">EventBuffer::read()</a> - Read data from an evbuffer and drain the bytes read</span>
   </li>
   <li class="member">
    <span class="methodname"><a href="eventbuffer.readline.html" class="methodname" rel="rdfs-seeAlso">EventBuffer::readLine()</a> - Extracts a line from the front of the buffer</span>
   </li>
   <li class="member">
    <span class="methodname"><a href="eventbuffer.appendfrom.html" class="methodname" rel="rdfs-seeAlso">EventBuffer::appendFrom()</a> - Moves the specified number of bytes from a source buffer to the
  end of the current buffer</span>
   </li>
  </ul>
 </div>

</div></div></div></body></html>